home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / f90 / pxfconst.z / pxfconst
Encoding:
Text File  |  1998-10-30  |  8.5 KB  |  190 lines
  1. PXFCONST(3F)                                           Last changed: 1-6-98
  2.  
  3.  
  4. NNAAMMEE
  5.      PPXXFFCCOONNSSTT, PPXXFFIISSCCOONNSSTT, IIPPXXFFCCOONNSSTT  - Returns the value associated with
  6.      symbolic constants
  7.  
  8. SSYYNNOOPPSSIISS
  9.      CCHHAARRAACCTTEERR**((_n)) _c_o_n_s_t_n_a_m_e
  10.      IINNTTEEGGEERR _i_v_a_l,, _i_e_r_r_o_r
  11.      LLOOGGIICCAALL PPXXFFIISSCCOONNSSTT,, 11
  12.  
  13.      ii = IIPPXXFFCCOONNSSTT (_c_o_n_s_t_n_a_m_e)
  14.      ll = PPXXFFIISSCCOONNSSTT (_c_o_n_s_t_n_a_m_e)
  15.      CCAALLLL PPXXFFCCOONNSSTT ((_c_o_n_s_t_n_a_m,, _i_v_a_l,, _i_e_r_r_o_r))
  16.  
  17. IIMMPPLLEEMMEENNTTAATTIIOONN
  18.      UNICOS, UNICOS/mk, and IRIX systems
  19.  
  20. DDEESSCCRRIIPPTTIIOONN
  21.      On IRIX systems, this routine is in lliibbffoorrttrraann..ssoo which is linked by
  22.      default when compiling programs with the MIPSpro 7 Fortran 90 compiler
  23.      or when compiling programs with the --ccrraayylliibbss option to the MIPSpro
  24.      7.2 F77 compiler.
  25.  
  26.      These functions provide a way for the Fortran programmer to get the
  27.      value of some symbolic constants defined in system header files.
  28.  
  29.      IIPPXXFFCCOONNSSTT() provides an integer return value but no error checking.
  30.      If the argument passed corresponds to one of the defined constants
  31.      shown below, the return value is the integer value associated with the
  32.      constant; if the argument is not a defined constant, the return value
  33.      is meaningless.  PPXXFFIISSCCOONNSSTT() confirms whether the argument is a valid
  34.      constant.  PPXXFFIISSCCOONNSSTT() returns .TRUE only if IIPPXXFFCCOONNSSTT() would return
  35.      a valid value for the same _c_o_n_s_t_n_a_m_e.
  36.  
  37.      Upon successful completion, the subroutine PPXXFFCCOONNSSTT() returns in _i_v_a_l
  38.      the integer value associated with the constant described by _c_o_n_s_t_n_a_m_e.
  39.  
  40.      When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
  41.      UNICOS, UNICOS/mk, or IRIX systems, all arguments must be of default
  42.      kind unless documented otherwise.  On UNICOS and UNICOS/mk, default
  43.      kind is KKIINNDD==88 for integer, real, complex, and logical arguments; on
  44.      IRIX, the default kind is KKIINNDD==44.
  45.  
  46.      The following is a list of arguments for these subroutines:
  47.  
  48.      _c_o_n_s_t_n_a_m_e An input character variable that represents the name of a
  49.                constant.  _c_o_n_s_t_n_a_m_e is case-sensitive, and trailing blanks
  50.                in the argument are ignored.
  51.  
  52.                The following are valid values for _c_o_n_s_t_n_a_m_e.  The second
  53.                column contains the system header file where the symbolic
  54.                constant is defined, or the standard where it is defined.
  55.  
  56.                ''FF__GGEETTLLKK''             <<ffccnnttll..hh>>
  57.  
  58.                ''FF__SSEETTLLKK''             <<ffccnnttll..hh>>
  59.  
  60.                ''FF__SSEETTLLKKWW''            <<ffccnnttll..hh>>
  61.  
  62.                ''FF__RRDDLLCCKK''             <<ffccnnttll..hh>>
  63.  
  64.                ''FF__WWRRLLCCKK''             <<ffccnnttll..hh>>
  65.  
  66.                ''FF__UUNNLLCCKK''             <<ffccnnttll..hh>>
  67.  
  68.                ''FF__DDUUPPFFDD''             <<ffccnnttll..hh>>
  69.  
  70.                ''FF__GGEETTFFDD''             <<ffccnnttll..hh>>
  71.  
  72.                ''FF__SSEETTFFDD''             <<ffccnnttll..hh>>
  73.  
  74.                ''FF__GGEETTFFLL''             <<ffccnnttll..hh>>
  75.  
  76.                ''FF__SSEETTFFLL''             <<ffccnnttll..hh>>
  77.  
  78.                ''FF__SSEETTSSBB''*            <<ffccnnttll..hh>>
  79.  
  80.                ''FF__SSEETTAALLFF''*           <<ffccnnttll..hh>>
  81.  
  82.                ''FF__CCLLRRAALLFF''*           <<ffccnnttll..hh>>
  83.  
  84.                ''OO__RRDDOONNLLYY''            <<ffccnnttll..hh>>
  85.  
  86.                ''OO__WWRROONNLLYY''            <<ffccnnttll..hh>>
  87.  
  88.                ''OO__RRDDWWRR''              <<ffccnnttll..hh>>
  89.  
  90.                ''OO__AACCCCMMOODDEE''           <<ffccnnttll..hh>>
  91.  
  92.                ''OO__NNDDEELLAAYY''            <<ffccnnttll..hh>>
  93.  
  94.                ''OO__AAPPPPEENNDD''            <<ffccnnttll..hh>>
  95.  
  96.                ''OO__SSYYNNCC''              <<ffccnnttll..hh>>
  97.  
  98.                ''OO__NNOONNBBLLOOCCKK''          <<ffccnnttll..hh>>
  99.  
  100.                ''OO__RRAAWW''*              <<ffccnnttll..hh>>
  101.  
  102.                ''OO__SSSSDD''*              <<ffccnnttll..hh>>
  103.  
  104.                ''OO__CCRREEAATT''             <<ffccnnttll..hh>>
  105.  
  106.                ''OO__TTRRUUNNCC''             <<ffccnnttll..hh>>
  107.  
  108.                ''OO__EEXXCCLL''              <<ffccnnttll..hh>>
  109.  
  110.                ''OO__NNOOCCTTTTYY''            <<ffccnnttll..hh>>
  111.  
  112.                ''00__BBIIGG''*              <<ffccnnttll..hh>>
  113.  
  114.                ''OO__PPLLAACCEE''*            <<ffccnnttll..hh>>
  115.  
  116.                ''OO__RREESSTTAARRTT''*          <<ffccnnttll..hh>>
  117.  
  118.                ''OO__AASSYYNNCC''*            <<ffccnnttll..hh>>
  119.  
  120.                ''OO__PPTTYYIIGGNN''*           <<ffccnnttll..hh>>
  121.  
  122.                ''OO__SSFFSSXXOOPP''*           <<ffccnnttll..hh>>
  123.  
  124.                ''OO__LLDDRRAAWW''*            <<ffccnnttll..hh>>
  125.  
  126.                ''OO__WWEELLLLFFOORRMMEEDD''*       <<ffccnnttll..hh>>
  127.  
  128.                ''OO__SSFFSS__DDEEFFEERR__TTMM''*     <<ffccnnttll..hh>>
  129.  
  130.  
  131.                ''SS__AALLFF__NNOOGGRROOWW''*       <<ssyyss//ssttaatt..hh>>
  132.  
  133.                ''SS__AALLFF__PPAARRTTRR''*        <<ssyyss//ssttaatt..hh>>
  134.  
  135.  
  136.                ''SSEEEEKK__SSEETT''            <<ssttddiioo..hh>>
  137.  
  138.                ''SSEEEEKK__CCUURR''            <<ssttddiioo..hh>>
  139.  
  140.                ''SSEEEEKK__EENNDD''            <<ssttddiioo..hh>>
  141.  
  142.  
  143.                ''SSTTDDIINN__FFIILLEENNOO''        PPOOSSIIXX..99
  144.  
  145.                ''SSTTDDOOUUTT__FFIILLEENNOO''       PPoossiixx..99
  146.  
  147.                ''SSTTDDEERRRR__FFIILLEENNOO''       PPoossiixx..99
  148.  
  149.                * = UNICOS and UNICOS/mk systems only
  150.  
  151.                Posix.9 specific errors:
  152.  
  153.                ''EENNOONNAAMMEE''             lliibbeerrrrnnoo..hh
  154.  
  155.                ''EENNOOHHAANNDDLLEE''           lliibbeerrrrnnoo..hh
  156.  
  157.                Errnos 1-98 from <<eerrrrnnoo..hh>>, for example:  ''EEPPEERRMM''
  158.  
  159.                Cray implementation errors:
  160.  
  161.                EEBBAADDIIDD                If the _i_d_i_r_i_d argument is an invalid
  162.                                      directory ID
  163.  
  164.                EEBBAADDHHAANNDDLLEE            If the handle is invalid
  165.  
  166.                Additional values for _c_o_n_s_t_n_a_m_e are described in
  167.                descriptions of other PXF routines such as PPXXFFAACCCCEESSSS,
  168.                PPXXFFCCHHMMOODD, PPXXFFCCRREEAATT, PPXXFFOOPPEENN, and so on.
  169.  
  170.      _i_v_a_l      An output integer variable.  The value associated with the
  171.                constant.
  172.  
  173.      _i_e_r_r_o_r    An output integer variable.  It contains the exit status.
  174.  
  175. EEXXIITT SSTTAATTUUSS
  176.      Upon successful completion, the argument _i_e_r_r_o_r is set to 0.  If any
  177.      of the following conditions occur, PPXXFFCCOONNSSTT() sets _i_e_r_r_o_r to the
  178.      corresponding value.
  179.  
  180.      EENNOONNAAMMEE        Invalid constant name
  181.  
  182.      EENNOOMMEEMM         PPXXFFCCOONNSSTT() could not allocate the memory required
  183.  
  184. SSEEEE AALLSSOO
  185.      PPXXFFAACCCCEESSSS(3F), PPXXFFCCHHMMOODD(3F), PPXXFFCCRREEAATT(3F)
  186.  
  187.      _A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _L_i_b_r_a_r_y _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-
  188.      2165, for the printed version of this man page.
  189.  
  190.